home *** CD-ROM | disk | FTP | other *** search
/ Amiga Inside! / Amiga FD Inside (1995)(Ultramax).iso / berndspd / musiktools / superplay / docs / spobject-docs / wav.doc < prev    next >
Text File  |  1994-12-13  |  5KB  |  144 lines
  1.  
  2.   WAV.svobject
  3.  
  4.   © 1994 by Andreas R. Kleinert.
  5.  
  6.   FREEWARE. All rights reserved.
  7.  
  8.   Version      : 2.3
  9.   Release Date : 11.12.1994
  10.  
  11.  
  12.   Description
  13.   ~~~~~~~~~~~
  14.   WAV.svobject is an external Library-Module for the superplay.library V1+.
  15.  
  16.   It supports reading and writing of PC RIFF-WAVE (WAV) Sample-Files,
  17.   playing is supported as far as the Amiga is able to (8 Bit only).
  18.  
  19.  
  20.   Author
  21.   ~~~~~~
  22.   Andreas R. Kleinert
  23.   Grube Hohe Grethe 23
  24.   D-57074 Siegen
  25.   Germany
  26.  
  27.  
  28.   History :
  29.   ~~~~~~~~~
  30.   V2.3 (11.12.1994) :
  31.  
  32.    - fixed internal bug
  33.  
  34.  
  35.   V2.2 (21.07.1994) :
  36.  
  37.    - added possibility to save all Samples from all multiple-SampleList
  38.      and to accept NULL parameters for the Source-SPObject with
  39.      SPO_Write(), so that custom applications may save their self-
  40.      created SampleLists by simply setting them via SPO_SetSampleList().
  41.      The old way behaviour is still supported (as also handling of
  42.      V1 SPObjects).
  43.    - in former versions the sourcebuffer had been left "trashed", because
  44.      conversion into the WAV format (via XOR) had not been reversed.
  45.      Now the old buffer is reconstructed after saving.
  46.  
  47.  
  48.   V2.1 (17.07.1994) :
  49.  
  50.    - integrated new "SampleList"-Functions for exporting more than one
  51.      sample
  52.  
  53.  
  54.   V1.4 (19.06.1994) :
  55.  
  56.    - version still reflected 1.2 instead 1.3. Now we're at 1.4 :-)
  57.    - changed way of reading the WAV-Header, so that files with
  58.      extended Headers (don't know if there are such files) might be
  59.      read as well in the future, while files with shortened header
  60.      (possibly corrupted) will no longer be accepted (they would be
  61.      interpreted wrong, anyway).
  62.    - made some WORDs to UWORDs
  63.    - fixed possible bug-source (memory)
  64.  
  65.  
  66.   V1.3 (29.04.1994) :
  67.  
  68.    - fixed (hopefully) "header not located" problems within memory
  69.      delocation
  70.    - also fixed AllocMem()/FreeVec() conflict with SampleData-Buffer
  71.  
  72.  
  73.   V1.2 (31.03.1994) :
  74.  
  75.    You should consider V1.1 to be a _BAD_ BETA-Version now, because :
  76.  
  77.    - as soon as I got some original (not converted) WAV-Files, I found
  78.      out, that V1.1 was more or less UN-USEABLE, because it was so
  79.      BUGGY ;<
  80.    - IntelToMotorola (and reverse) conversion was not correct for
  81.      LONGwords, which concerned :
  82.  
  83.       - ChunkSize           (File Header : FileSize)
  84.       - SubSize             (Fmt  Chunk  : Chunk Size)
  85.       - SamplesPerSec       (Fmt  Chunk  : Frequency)
  86.       - BytesPerSec         (Fmt  Chunk  : Frequency, stereo)
  87.       - DataSize            (Data Chunk  : Chunk Size)
  88.  
  89.      If you were "lucky", this might have meant, that the samples would
  90.      have been played too short and with the wrong frequency ;)
  91.      If you were "unlucky", they would not have been played at all !
  92.  
  93.      Due to these bugs, only self-written WAV-Files were replayed
  94.      correctly, because they were WRITTEN AS WRONG as they have been read.
  95.    - The Fmt-Header ID was written as "FMT " instead of "fmt ", so that
  96.      perhaps not all other programs might accept files written with the
  97.      old V1.1-WAV.spobject.
  98.      Nevertheless you may recover your self-created WAV-Files by passing
  99.      them through the Freeware-Tool SoundZAP V2.3 (Fish-Disk 646), which
  100.      accepts them obviously (only the frequency might be wrong).
  101.  
  102.    - Now the positive things :
  103.  
  104.      - with this version not only the File Header, but also the single Chunks
  105.        are now checked for their correct IDs : - "WAVE","RIFF" (Header)
  106.                                                - "fmt "        (Fmt-Chunk)
  107.                                                - "data"        (Data-Chunk)
  108.      - since this version also a length of the Fmt-Chunk greater than
  109.        16 Bytes will be handled correctly : this definitely will not happen
  110.        at the time, but may happen with future expansions of the RIFF-WAVE-
  111.        Format
  112.      - the Longword-Conversion now works ;)
  113.      - now testing with "real" WAV-Files has been done :
  114.        there's a high probability now, that all WAV-Files - assuming that
  115.        they actually fit into your Chip Memory ;) - will be played in the
  116.        right way
  117.      - now there's more information given about the loaded Sample :
  118.        This information will even be available, even if there's not enough
  119.        memory to store the actual sample-data (e.g. more than 2 MByte
  120.        sample data against 1 MByte free Chip Memory)
  121.      - and more
  122.  
  123.  
  124.   V1.1 (30.03.1994) :
  125.  
  126.    - we use RawDoFmt()-based sprintf()-routine, instead of SAS/C's.
  127.      This saves about 1800 Bytes.
  128.    - "utility.library" is not used, because this crashes the Player-Task
  129.      and no reason for this could be found.
  130.    - first version
  131.  
  132.  
  133.   Literature
  134.   ~~~~~~~~~~
  135.   [1] "c't", Magazin für Computertechnik, Issue 1/1993, DMV-Verlag
  136.  
  137.  
  138.   Copyrights
  139.   ~~~~~~~~~~
  140.   Some of the mentioned names or products above may be copyrighted by
  141.   companies or trademarks of companies.
  142.  
  143.  
  144.